home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 801_900 / DISK0843 / DISK0843.ZIP / OMEGA.DOC < prev    next >
Text File  |  1988-02-13  |  102KB  |  2,377 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                   Quick Help Sheet of Commands for Omega-Link                  Quick Help Sheet of Commands for Omega-Link
  7.  
  8.                                    Alt Keys                                   ________
  9.  
  10. Alt-A) ASCII File Transfer (Upload/download ASCII files, perform sessionAlt-A)                                                                  
  11.        captures, etc. . . .)
  12. Alt-B) Toggle Split Screen mode on or offAlt-B)                                   
  13. Alt-C) Clear the screen (and change to any new colors)Alt-C)                                                
  14. Alt-D) Dial a telephone number or go into the dialing directoryAlt-D)                                                         
  15. Alt-E) Turn local echo on or off (hit this if you can't see what you typeAlt-E)                                                                   
  16.        or characters are appearing double)
  17. Alt-F) Execute the file systemAlt-F)                        
  18. Alt-G) Turn automatic on-line ANSI graphics viewing on or offAlt-G)                                                       
  19. Alt-H) Hang up the phoneAlt-H)                  
  20. Alt-I) Set the speed at which macros are sentAlt-I)                                       
  21. Alt-J) Load Alt 1-0 keys from a disk fileAlt-J)                                   
  22. Alt-K) Call up the function key definitions for viewing/editingAlt-K)                                                         
  23. Alt-L) Initialize the printerAlt-L)                       
  24. Alt-M) Initialize the modemAlt-M)                     
  25. Alt-N) Send a null signalAlt-N)                   
  26. Alt-O) Toggle automatic ANSI music playing on or offAlt-O)                                              
  27. Alt-P) Call up the parameters menu (used to set modem commands, colors, andAlt-P)                                                                     
  28.        many other features)
  29. Alt-Q) Toggle automatic on-line RLE graphic (picture) viewing on or offAlt-Q)                                                                 
  30. Alt-R) Redial the last number that was dialedAlt-R)                                       
  31. Alt-S) Toggle the sound on or offAlt-S)                           
  32. Alt-T) Set the Time and DateAlt-T)                      
  33. Alt-U) Run a script fileAlt-U)                  
  34. Alt-V) View a RLE graphics (picture) fileAlt-V)                                   
  35. Alt-W) Wait for XX seconds (this is a macro command)Alt-W)                                              
  36. Alt-X) Exit to DOSAlt-X)            
  37. Alt-Y) Toggle external help windows on or offAlt-Y)                                       
  38. Alt-Z) Shell to DOSAlt-Z)             
  39.  
  40.  
  41.                                     Other Keys                                    __________
  42.  
  43. Ctrl-PgUp ) Upload a binary file (using XMODEM, YMODEM, etc.  . .)Ctrl-PgUp )                                                       
  44. Ctrl-PgDn ) Download a binary file ("      "       "     ")Ctrl-PgDn )                                                
  45. Ctrl-End  ) Send a break signalCtrl-End  )                    
  46. Shift-Tab ) Turn linefeeds on or off (use this if lines are being writtenShift-Tab )                                                              
  47.             on top of one another or things are double spaced)
  48. Ctrl-Break) Will terminate the execution of a macroCtrl-Break)                                        
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                   Omega-Link
  73.                             (Formerly "Omega-Term")
  74.  
  75.                                  Version 2.10a
  76.               (C)Copyright 1987-1988 by Thomas Goodson and Eugene Kopf
  77.                               All Rights Reserved
  78.  
  79.  
  80.  
  81.          Omega-Link took time and effort to develop.  Like many large pro-
  82.     jects, the credit cannot go to a select handful.  It took suggestions,
  83.     patience, and a great deal of thinking on everyone's part to make this
  84.     program what it is today.  While we cannot list the names of all those
  85.     who helped us, here is a small list of some people to whom we would
  86.     especially like to send our thanks:
  87.  
  88.         Dave Manning        One of our most helpful "Beta-Testers," and        Dave Manning                                                   
  89.                             whose constant "nagging" on various items
  90.                             greatly improved the quality of the program.
  91.         Jim Rhoads          First, we must thank Jim for his patience as        Jim Rhoads                                                      
  92.                             "Sysop" of The Strange Quark [(616) 964-0930]
  93.                             whose patience was probably tried a great deal
  94.                             by our constant "log-ons" to his system to help
  95.                             debug the program.  In addition, we owe him our
  96.                             thanks for permitting us to use his machines at
  97.                             his home and his creative ideas.
  98.         Jan Goodson         Whose perspective as a new user to telecommu-        Jan Goodson                                                      
  99.                             nications and abilities for relating to people
  100.                             proved to be a constant benefit.
  101.         Steve Harke         Without Steve's abilities in writing "BBS"        Steve Harke                                                   
  102.                             software, Omega-Link would be seriously lack-
  103.                             ing.  And so would our enthusiasm.
  104.         Bob Gavrun          We cannot thank this individual enough for the        Bob Gavrun                                                        
  105.                             time he took away from his own free time (which
  106.                             he has little enough as it is) to help us with
  107.                             the program, documentation, and interfaces.
  108.         Bill Bailey         He suggested the name of "Omega," meaning the        Bill Bailey                                                      
  109.                             first and last you will ever need in modem
  110.                             communications, just as Omega is the last
  111.                             character in the Greek alphabet.
  112.         Fione Chase         Her wisdom and ideas have proven invaluable.        Fione Chase                                                     
  113.         Mike Curry          Who helped us give our business a boost.        Mike Curry                                                  
  114.  
  115.          The members of the various Bulletin Boards of the Battle Creek
  116.     area, and the members of "Personal Computers of Battle Creek."
  117.  
  118.         And finally, we cannot ignore our family members and close friends.
  119.     Their patience and tolerance in regard to our severe mood swings,
  120.     bizarre hours, and crazy actions should not be ignored.  We owe them
  121.     almost infinite gratitude for all of this, which so few mortals can
  122.     take so well.
  123.  
  124.          In this manual, we use the Trademarked word "Hayes," whose trade-
  125.     mark is held by Hayes Microcomputer Products, Inc.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                                Table of Contents                               Table of Contents
  139.  
  140.     Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3  
  141.     Getting Started  . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  142.     Additional Tips for Beginners  . . . . . . . . . . . . . . . . . . . 4
  143.     Command Directory  . . . . . . . . . . . . . . . . . . . . . . . . . 5
  144.     Terminal Mode Commands . . . . . . . . . . . . . . . . . . . . . . . 5
  145.           ASCII Transfer . . . . . . . . . . . . . . . . . . . . . . . . 5
  146.           Print Screen . . . . . . . . . . . . . . . . . . . . . . . . . 6
  147.           Send Null  . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  148.           View an RLE file . . . . . . . . . . . . . . . . . . . . . . . 6
  149.           Shell to DOS . . . . . . . . . . . . . . . . . . . . . . . . . 6
  150.     File System Commands . . . . . . . . . . . . . . . . . . . . . . . . 7
  151.           Changing File Attributes . . . . . . . . . . . . . . . . . . . 7
  152.     Parameters Menu  . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  153.           Communications Parameters  . . . . . . . . . . . . . . . . . . 8
  154.     Dialing Directory  . . . . . . . . . . . . . . . . . . . . . . . . . 9
  155.     Uploading & Downloading Files  . . . . . . . . . . . . . . .. . . . 11
  156.     Function Keys (Macros)  . . . . . . . . . . . . . . . . . . . . . . 12
  157.           Function Key Options & Conversion Tables  . . . . . . . . . . 13
  158.     The Script Language . . . . . . . . . . . . . . . . . . . . . . . . 14
  159.           Script Language Commands & Syntaxes . . . . . . . . . . . . . 14
  160.                 BAUD  . . . . . . . . . . . . . . . . . . . . . . . . . 14
  161.                 CLS . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  162.                 DATA  . . . . . . . . . . . . . . . . . . . . . . . . . 15
  163.                 DIAL  . . . . . . . . . . . . . . . . . . . . . . . . . 15
  164.                 DISPLAY . . . . . . . . . . . . . . . . . . . . . . . . 15
  165.                 ECHO  . . . . . . . . . . . . . . . . . . . . . . . . . 15
  166.                 ELSE  . . . . . . . . . . . . . . . . . . . . . . . . . 16
  167.                 ENDIF . . . . . . . . . . . . . . . . . . . . . . . . . 16
  168.                 EXIT  . . . . . . . . . . . . . . . . . . . . . . . . . 16
  169.                 GOSUB . . . . . . . . . . . . . . . . . . . . . . . . . 16
  170.                 GOTO  . . . . . . . . . . . . . . . . . . . . . . . . . 17
  171.                 GRAPHICS  . . . . . . . . . . . . . . . . . . . . . . . 17
  172.                 HANGUP  . . . . . . . . . . . . . . . . . . . . . . . . 17
  173.                 IF  . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  174.                 INPUT . . . . . . . . . . . . . . . . . . . . . . . . . 19
  175.                 LINEFEEDS . . . . . . . . . . . . . . . . . . . . . . . 19
  176.                 LOCATE  . . . . . . . . . . . . . . . . . . . . . . . . 19
  177.                 MUSIC . . . . . . . . . . . . . . . . . . . . . . . . . 19
  178.                 PARITY  . . . . . . . . . . . . . . . . . . . . . . . . 20
  179.                 PAUSE . . . . . . . . . . . . . . . . . . . . . . . . . 20
  180.                 PLAY  . . . . . . . . . . . . . . . . . . . . . . . . . 20
  181.                 RECEIVE . . . . . . . . . . . . . . . . . . . . . . . . 21
  182.                 RETURN  . . . . . . . . . . . . . . . . . . . . . . . . 21
  183.                 RLE . . . . . . . . . . . . . . . . . . . . . . . . . . 21
  184.                 SEND  . . . . . . . . . . . . . . . . . . . . . . . . . 22
  185.                 SOUND . . . . . . . . . . . . . . . . . . . . . . . . . 22
  186.                 STOP  . . . . . . . . . . . . . . . . . . . . . . . . . 22
  187.                 TIMEOUT . . . . . . . . . . . . . . . . . . . . . . . . 22
  188.                 WAITFOR . . . . . . . . . . . . . . . . . . . . . . . . 22
  189.                 LABELS  . . . . . . . . . . . . . . . . . . . . . . . . 22
  190.                 MULTPILE COMMANDS PER LINE  . . . . . . . . . . . . . . 23
  191.                 COMMENTS  . . . . . . . . . . . . . . . . . . . . . . . 23
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.     Appendix A - ASCII & Extended ASCII Character Codes . . . . . . . . 24
  205.     Appendix B - Glossary . . . . . . . . . . . . . . . . . . . . . . . 26
  206.     Appendix C - Trouble Shooting Guide . . . . . . . . . . . . . . . . 30
  207.     Appendix D - Commands for Editing Strings . . . . . . . . . . . . . 32
  208.     Appendix E - Sequence of Steps Performed by Omega When It Begins  . 33
  209.     Appendix F - Suggestion Form  . . . . . . . . . . . . . . . . . . . 34
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  267.  
  268.  
  269.  
  270.                                  INTRODUCTION                                 INTRODUCTION
  271.  
  272.  
  273.          Omega-Link is a program that lets you use your modem to communi-
  274.     cate with other computers.  It was written entirely in 8088 assembly
  275.     language, for speed and ease of use.  For the beginning user, Omega-
  276.     Link offers powerful commands with easy-to-remember keystrokes.
  277.  
  278.          The file-system of Omega-Link can perform functions that rival
  279.     those of MSDOS.  Any directory listing will show ALL files on the dis-
  280.     kette, including hidden files, read-only files, and subdirectories.
  281.  
  282.          The best way to learn Omega-Link is to use it.  If you are unsure
  283.     of what various functions do, try them.  You cannot harm anything.  If
  284.     you are about to do something that you might regret, such as deleting a
  285.     file, Omega-Link will give you a warning message to confirm the action.
  286.  
  287.          Good luck and enjoy yourself!
  288.  
  289.  
  290.  
  291.                                 GETTING STARTED                                GETTING STARTED
  292.  
  293.  
  294.          Welcome to Omega-Link.  These next few paragraphs are designed for
  295.     the novice user.  If you consider yourself an advanced user and are
  296.     familiar with the area of communications, we suggest you skip this por-
  297.     tion and go directly to the reference manual, which begins at the
  298.     section entitled "The Command Directory."
  299.  
  300.          Telecommunications can be a puzzling and sometimes exasperating
  301.     field, and can require some patience in learning.  We have tried to
  302.     make this as simple a task as possible without sacrificing power.  How-
  303.     ever, it will still require effort on your part to learn because it
  304.     requires not only that you know how to use Omega-Link, but also how to
  305.     use the software of the computer with which you are communicating.
  306.  
  307.          This start-up document is not intended to teach you everything,
  308.     and we recommend that you consult the reference manual afterwards.
  309.     Also, please note that there is a glossary at the end of the reference
  310.     manual, and a quick help sheet in the beginning.  We suggest that you
  311.     print these out and have them nearby while you are beginning the learn-
  312.     ing process.
  313.  
  314.          Before we go any further, you need to locate your modem manual(s)
  315.     and find out the baud rate, which com port your modem is connected to,
  316.     and whether it is "Hayes(tm) Compatible" i.e., compatible with a Hayes
  317.     modem.
  318.  
  319.          Start Omega-Link by typing "OMEGA" at the DOS prompt.  When the
  320.     opening screen appears, read it, and then press any key when you are
  321.     done.  The next screen will point out how to get the main help menu.
  322.     Ignore it for now and hold down the "Alt" key and press "P."  Now
  323.     release them.  The keys that you have just press (Alt & P) held
  324.     together are known as "Alt-P." Likewise, if you would see a mentioning
  325.  
  326.  
  327.                                     -3-
  328.  
  329.  
  330.  
  331.  
  332.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  333.  
  334.  
  335.  
  336.     in the program for "Alt-Z," simply hold down the "Alt" key and press
  337.     "Z," and then release them.
  338.  
  339.          Press "C,"  and you will be in the Communications Parameters set
  340.     up screen.  If you need to change the baud rate, make sure the baud
  341.     rate field is highlighted, press F1, type in the new baud rate, and
  342.     press enter.  Now look at the entry for the active port.  If it is dif-
  343.     ferent than the com port that your modem is connected to, move the cur-
  344.     sor to that field and enter the proper number for you com port.  To
  345.     finish, press F10.
  346.  
  347.          If your modem is Hayes compatible, you may skip the following sec-
  348.     tion, and go to the section entitled "Additional Tips for Beginners."
  349.     If it is not, please read on. 
  350.  
  351.          Press "M" to display the Modem and Printer commands screen. Using
  352.     your modem manual, find the information needed for: Dialing Prefix,
  353.     Dialing Suffix, Hang-up String, and the Connect Prompt. Erase the modem
  354.     initialization string, and the no connect prompts.  Before entering the
  355.     information you just located you will need to translate your manual's
  356.     direction of pressing return or enter to "{" and were your manual calls
  357.     for a delay use ' ~ ' for a one-half second delay. If you require more
  358.     than one-half second delay, use more than one ' ~ '.  Press F10 when
  359.     you are finished.  You are at the parameters menu once again.
  360.  
  361.          When you are finished configuring Omega Link to your hardware,
  362.     press Q to save your set up to the disk.
  363.  
  364.          To use any additional options available in the parameters menu,
  365.     use the help windows and/or the reference manual as a guide.
  366.  
  367.          You are almost ready to use Omega-Link.  But before you are, we
  368.     have a few brief items for you to keep in mind:
  369.  
  370.  
  371.                          Additional Tips for Beginners                         Additional Tips for Beginners
  372.  
  373.          Know the computer that you are calling:  When you discover a new         Know the computer that you are calling:                         
  374.     computer system to call, make sure to find out the number of data bits,
  375.     the parity that they are using, the number of stop bits, and the baud
  376.     rate.  Most systems use 8 bits, no parity, and 1 stop bit, but not all.
  377.     Most host computers will support 300 baud.  Some systems that you call
  378.     will not support higher baud rates, so you may need to experiment.
  379.  
  380.          Do not be afraid to experiment:  If you do not know what baud         Do not be afraid to experiment:                              
  381.     rates, data bits, stop bits, or parity they use, try experimentation.
  382.     The first step is to try 300 baud.  Then try changing the number of
  383.     data bits, and the parity.  Once you are on a new system, they will
  384.     probably tell you if they support higher baud rates, so higher baud
  385.     rates while experimenting are usually not necessary.  Your main objec-
  386.     tive is to get a hold of the host system and be able to read what they
  387.     send to you.
  388.  
  389.          Use the Alt-D command to dial a telephone number:  The dialing         Use the Alt-D command to dial a telephone number:             
  390.     screen will ask you to type the phone number, then you should press
  391.  
  392.  
  393.                                     -4-
  394.  
  395.  
  396.  
  397.  
  398.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  399.  
  400.  
  401.  
  402.     enter to dial it.  If you wish to change the number of data bits, stop
  403.     bits, parity, or baud rate, do so from the "Communications Parameters"
  404.     menu which is in the "Parameters Menu" (Alt-P).
  405.  
  406.          If you dial a telephone number frequently, we suggest that you
  407.     store the number inside of the dialing directory.  This way, whenever
  408.     you dial a telephone number, the number of data bits, stop bits, par-
  409.     ity, and baud rate, in addition to other features, are all set for you
  410.     automatically when you dial.
  411.  
  412.  
  413.                              THE COMMAND DIRECTORY                             THE COMMAND DIRECTORY
  414.  
  415.  
  416.          Omega-Link features four major subsystems: Terminal mode, the
  417.     Dialing Directory, the Files Menu, and the Parameters Menu.  Commands
  418.     to control how the system operates, and its external functions, are
  419.     entered from the subsystem menus.  This would include data items such
  420.     as phone numbers, as well as utility commands to show disk space, get a
  421.     directory, and so forth.  These functions have their own menu.
  422.  
  423.          We will discuss each of the four subsystems separately; however,
  424.     note that there is some duplication in related functions between menus.
  425.  
  426.  
  427.  
  428.                             Terminal Mode Commands                            Terminal Mode Commands
  429.  
  430.          Frequently-used commands can be executed directly from terminal
  431.     mode, using some combination of the Alt key, Ctrl key, and the other
  432.     keys of the keyboard.  These terminal mode commands do not execute from
  433.     a menu, but you can display the list by hitting the Home key.
  434.  
  435.  
  436.          ASCII Transfer (Alt-A)         ASCII Transfer (Alt-A)
  437.  
  438.          This feature allows you to upload or download a file using the
  439.     binary protocols, or to capture any incoming text with a text capture
  440.     option.  Here is a description of the ASCII protocols used for upload-
  441.     ing a file that you can access through this command:
  442.  
  443.          ASCII - This will send the file to the host system exactly as it
  444.     is stored in a disk file.
  445.  
  446.          Prompted ASCII - Will send a file to the host computer one line at
  447.     a time.  After a line is sent, it will wait to receive a character
  448.     (which you define when you select the Prompted ASCII mode) from the
  449.     host system, and then continue.
  450.  
  451.          Files can be downloaded by only two methods.  The first method is
  452.     a straight ASCII transfer.  Omega-Link will store every character it
  453.     receives in a disk file until it receives an end-of-file character
  454.     (ASCII value 26).  The second method is a straight text capture.  This
  455.     will store every character that is received from your modem in a disk
  456.     file until you press Alt-A again, which will close the file.
  457.  
  458.  
  459.                                     -5-
  460.  
  461.  
  462.  
  463.  
  464.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  465.  
  466.  
  467.  
  468.          Print-Screen (Shift-PrtSc)         Print-Screen (Shift-PrtSc)
  469.  
  470.          Omega-Link intercepts the Print Screen function of MSDOS to pro-
  471.     vide another data capture method, accomplished with the Shift and PrtSc
  472.     keys.  Screen data is saved to a disk file specified in the Parameters
  473.     Menu, usually SCREEN.DMP.  The difference is that the screen dump data
  474.     consists of the data on the screen only.  It is also appended to the
  475.     end of the file.
  476.  
  477.          Both the session capture data and the screen dump data can be sent
  478.     directly to the printer, by specifying PRN or LPT1 as the capture file
  479.     or screen dump file.  Generally, you will send the session capture data
  480.     to a disk file, and screen dumps to the printer, but your needs may be
  481.     different.
  482.  
  483.  
  484.          Send Null (Alt-N)         Send Null (Alt-N)
  485.  
  486.          Null and sustained-break signals are sometimes useful in communi-
  487.     cating with a mainframe computer.  A Null character has the ASCII value
  488.     of 0.  A sustained-break is not actually a character, but is a line
  489.     condition.  Omega-Link sends a sustained-break signal when you key
  490.     Ctrl-End.
  491.  
  492.          On a serial line not using a modem, a Break signal pulls the line
  493.     low for a duration of 200 to 600 milliseconds.  When using a modem, the
  494.     Break signal tells the modem to send a constant Space tone, which the
  495.     receiving end interprets as a Break.  When communicating with a main
  496.     frame computer, a Break signal is typically used to get attention for
  497.     the terminal, but it could be programmed to mean anything.
  498.  
  499.  
  500.          View an RLE file (Alt-V)         View an RLE file (Alt-V)
  501.  
  502.          You can view what is known as a RLE file on the screen by using
  503.     this command.  A RLE file is a file that contains special characters
  504.     designed so that you may view a graphics picture on the screen.  They
  505.     were originally used on certain subscription host systems for display-
  506.     ing weather maps, but the computer community has expanded their role so
  507.     that all sorts of pictures can be distributed.  They chief advantage to
  508.     an RLE file is that a graphics picture can be distributed over the
  509.     modems so that they may be viewed by many types of computers, rather
  510.     than just one specific brand.
  511.  
  512.          In order to use this feature, you must have a Color Graphics or
  513.     Enhanced Graphics adapter.
  514.  
  515.  
  516.          Shell to DOS (Alt-Z)         Shell to DOS (Alt-Z)
  517.  
  518.          This is a "terminate and stay resident" command.  Omega-Link
  519.     remains in memory, but reloads the MSDOS command processor to execute
  520.     other programs.  When you wish to return to Omega-Link, type "Exit" at
  521.     the DOS command prompt.  You will re-enter Omega-Link at the same point
  522.     where you left.
  523.  
  524.  
  525.                                     -6-
  526.  
  527.  
  528.  
  529.  
  530.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  531.  
  532.  
  533.  
  534.  
  535.          Warning: If you have shelled to DOS, use any other memory-resident
  536.     programs with caution.  These programs also install themselves in mem-
  537.     ory, and may cause problems when returning to Omega-Link!  Furthermore,
  538.     do not shell to a different version number of MSDOS, or the system may
  539.     crash.
  540.  
  541.  
  542.                              File System Commands                             File System Commands
  543.  
  544.  
  545.          The file-system of Omega-Link lets you handle disk files without
  546.     having to exit to DOS.  The file-system also has several commands not
  547.     directly available from the operating system of the microcomputer.
  548.  
  549.          The File-System Menu is brought-up with the Alt-F key combination.
  550.     You will see a list of available commands.  You may select these com-
  551.     mands by either pressing the key indicated, or by using the cursor keys
  552.     to move to the entry you want, then pressing the return key.
  553.  
  554.          While you are learning the commands, work on a scratch (spare)
  555.     diskette.  If you accidentally corrupt or erase some files on your
  556.     disk, you will not destroy some irreplaceable program.
  557.  
  558.          All commands are thoroughly described in their help screens, with
  559.     one exception: "Changing File Attributes."  This command is described
  560.     below.
  561.  
  562.  
  563.          Changing File Attributes (F)         Changing File Attributes (F)
  564.  
  565.          With this command, you can change the attributes of any file.  The
  566.     file attributes indicate various information about the file.  File
  567.     attributes can be:
  568.  
  569.          Read-Only - This indicates that the file can only be read, and can         Read-Only                                                         
  570.     not be written to or deleted.  Useful for files that you do not wish to
  571.     change or delete.
  572.  
  573.          Hidden - A hidden file attribute will prevent the file from show-         Hidden                                                           
  574.     ing in a directory listing, executed with the DIR command in MSDOS.
  575.  
  576.          System - This attribute indicates that the file is part of DOS.         System                                                         
  577.     This attribute has limited value, since it does not affect usage of the
  578.     file.
  579.  
  580.          Volume Label - Indicates that this really is not a file, but         Volume Label                                                
  581.     rather the name is to be used as the volume label of the disk. Although
  582.     you are able to change this on screen, DOS will not permit the change
  583.     to actually occur.
  584.  
  585.          Subdirectory - This attribute indicates that this is a subdirec-         Subdirectory                                                    
  586.     tory, and not a file.  Although you are able to change this on screen,
  587.     DOS will not permit the change to actually occur.
  588.  
  589.  
  590.  
  591.                                     -7-
  592.  
  593.  
  594.  
  595.  
  596.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  597.  
  598.  
  599.  
  600.          Archive Bit - Indicates that the file needs to be backed-up with         Archive Bit                                                     
  601.     the "BACKUP" command of DOS.  This is really only of significance to
  602.     those people with hard disks.
  603.  
  604.  
  605.                               The Parameters Menu                              The Parameters Menu
  606.  
  607.          The Parameters Menu is invoked by pressing Alt-P.  It provides
  608.     routines to change screen colors, modem command strings, default file
  609.     names, communications settings, and many other things.  To select an
  610.     item on the Parameters Menu, either press the first letter of the
  611.     selection desired, or use the cursor keys to move to the selection, and
  612.     then press the Enter key.
  613.  
  614.          Some of the Parameters Menu commands are the same as Terminal Mode
  615.     commands.  Bear in mind that changes made from the Parameters Menu are
  616.     default settings.  That is, they are the settings in place when you
  617.     start the program.  They may still be toggled or changed from one or
  618.     more menus, but the on-line changes are temporary.  When you make a
  619.     change in the Parameters menu and wish for them to become defaults
  620.     every time you execute Omega-Link, press "Q," which stands for "Quit
  621.     and Save."  If you wish to have the changes you have made become
  622.     default on a temporary basis (that is, if you wish for these changes to
  623.     remain in effect during this Omega-Link session), press "Z" for "Quit
  624.     and Don't Save."  Finally, if you have made some changes that you do
  625.     not wish to remain in effect, but would rather have your old settings
  626.     back again, select "A" for "Abort Changes."
  627.  
  628.          Here are some additional notes about the Parameters Menu that are
  629.     not covered in the Help Screens:
  630.  
  631.  
  632.          Communications Parameters         Communications Parameters
  633.  
  634.          The communications parameters involve several factors.  Here is a
  635.     detailed list of the options available on this menu, and what they do.
  636.  
  637.          Active Port - The valid com port values for Omega-Link are 1, 2,         Active Port                                                     
  638.     3, and 4.  Com ports 3 and 4 correspond to the I/O addresses 2E8 and
  639.     2E0 (these numbers are in hexadecimal).
  640.  
  641.          Baud Rate - Valid values are 60, 100, 110, 150, 300, 350, 400,         Baud Rate                                                     
  642.     450, 600, 1200, 2400, 4800, 9600, 19200, 38400.  Use only a number that
  643.     your modem can handle.
  644.  
  645.          Stop Bits - Accepted values are 1, 1.5, and 2.  Usually only 1         Stop Bits                                                     
  646.     stop bit is used.  Please note that Omega-Link does not allow for 1.5
  647.     stop bits.
  648.  
  649.          Strip/Convert - Omega-Link can change any character sent to the         Strip/Convert                                                  
  650.     host computer into another character.  Enter the 3-digit ASCII code of
  651.     the character to change as the Strip value, and the character to change
  652.     it to as the Convert value.  See the Omega-Link Function Key and con-
  653.     version table located in Appendix A for the ASCII values.
  654.  
  655.  
  656.  
  657.                                     -8-
  658.  
  659.  
  660.  
  661.  
  662.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  663.  
  664.  
  665.  
  666.                              The Dialing Directory                             The Dialing Directory
  667.  
  668.  
  669.          The dialing directory contains the telephone numbers you can dial
  670.     by typing the entry number.  This saves you the trouble of having to
  671.     memorize numbers, as well as giving you a means to store brief com-
  672.     ments, automatically set up parity, data bits, stop bits, etc.  for
  673.     each number dialed, and to automatically redial a number.
  674.  
  675.          Automatic dialing is invoked by pressing Alt-D.  The program will
  676.     ask you for the number of your selection.  Press return to see the
  677.     directory, or type in the number of the entry you wish to dial.  If you
  678.     type in a number from 1 to 100, it will dial that corresponding entry.
  679.     If you type in a number longer than three digits, it will send that to
  680.     the modem "as is".
  681.  
  682.          Assuming that you have pressed return and are viewing the list of
  683.     entries, here is a list of your options, what they do, and how to use
  684.     them:
  685.  
  686.  
  687.          Autodial         Autodial
  688.  
  689.          Enter the number of the selection, and the computer will automati-
  690.     cally dial the number for you.  It will also set the baud rate, word
  691.     length, parity, stop bits, and strip/convert characters associated with
  692.     the entry.  If it fails to connect, it will redial five times.  If you
  693.     want to keep dialing, press Alt-R.  This brings up the redial function,
  694.     which redials the last number dial up to 50 times before aborting the
  695.     redial process.
  696.  
  697.  
  698.          Erase an Entry         Erase an Entry
  699.  
  700.          This will erase the contents of an entry.  Do this only if you are
  701.     sure you wish to erase the entry.
  702.  
  703.  
  704.          Load Another Directory         Load Another Directory
  705.  
  706.          The dialing directory can store up to 100 entries.  However, for
  707.     some users this is not enough.  Therefore, you can create another
  708.     directory which has the capability for 100 more entries.  In order to
  709.     use these entries, just call up the new directory, and the one cur-
  710.     rently in memory will be replaced.
  711.  
  712.  
  713.          Manual Dial         Manual Dial
  714.  
  715.          This option lets you dial a telephone number without storing it in
  716.     the dialing directory.  You will be asked for the number, baud rate,
  717.     number of data bits, parity, and number of data bits.  If you want any
  718.     strip/convert capabilities, you must set that up also.  Although you
  719.     may enter name and comments if you wish, the information will not be
  720.     stored.
  721.  
  722.  
  723.                                     -9-
  724.  
  725.  
  726.  
  727.  
  728.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  729.  
  730.  
  731.  
  732.          Page Through Directory Entries         Page Through Directory Entries
  733.  
  734.          The dialing directory displays only ten items at a time.  In order
  735.     to look at the next ten items or the previous ten items, you can use
  736.     the "+" key to jump to the next page, and the "-" key to look at the
  737.     previous page.
  738.  
  739.  
  740.          Quit the Dialing Directory         Quit the Dialing Directory
  741.  
  742.          This exits the dialing directory and returns you to terminal mode.
  743.  
  744.  
  745.          Update an Entry         Update an Entry
  746.  
  747.          This feature allows you to set up a dialing directory entry, and
  748.     to tell Omega-Link what options and features to enact when dialing the
  749.     entry or after connection.  The entry fields and their functions are
  750.     described below:
  751.  
  752.         Name:               This is the name of the host system for that        Name:                                                           
  753.                             particular entry number.
  754.         Command File:       This is the name of a the script file that will        Command File:                                                      
  755.                             be automatically loaded and executed if Ome-
  756.                             ga-Link manages to connect with this entry.  If
  757.                             no file name is given, no script file will be
  758.                             loaded, and this feature will be disabled.
  759.         Phone No.:          The telephone number to be used for this entry.        Phone No.:                                                         
  760.         Macro File:         The name of the Alt-1 through Alt-0 function        Macro File:                                                     
  761.                             key file that will be loaded upon connection.
  762.         Xon/Xoff:           Tells whether the entry on hand supports the        Xon/Xoff:                                                       
  763.                             Xon/Xoff characters and their functions.
  764.         Linefeeds:          A "Y" tells Omega-Link to display a linefeed        Linefeeds:                                                      
  765.                             with every carriage return that is received by
  766.                             this entry.
  767.         Echo:               A "Y" tells Omega that local echo should be        Echo:                                                          
  768.                             enabled while communicating with this entry.
  769.         Sound:              A "Y" indicates that Omega may make sounds out        Sound:                                                            
  770.                             of the speaker while communicating with this
  771.                             entry.
  772.         Baud Rate:          The baud rate of the entry on hand.        Baud Rate:                                             
  773.         Data Bits:          The number of data bits that this entry uses.        Data Bits:                                                       
  774.         Parity:             The type of parity that the entry uses (E, O,        Parity:                                                          
  775.                             or N).
  776.         Stop Bits:          The number of stop bits that the entry uses.        Stop Bits:                                                      
  777.         Ansi Music:         Tells whether Omega should try to play ANSI        Ansi Music:                                                    
  778.                             music if told to do so.  ANSI graphics must
  779.                             also be enabled for this to work.
  780.         RLE Graphics:       Tells whether on-line RLE graphics should be        RLE Graphics:                                                   
  781.                             enabled for this system.  As with ANSI music,
  782.                             ANSI graphics must be enabled for this feature
  783.                             to work.
  784.         Last Called:        The date that the last call was made to this        Last Called:                                                    
  785.                             system.  You cannot edit this, only view it.
  786.  
  787.  
  788.  
  789.                                    -10-
  790.  
  791.  
  792.  
  793.  
  794.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  795.  
  796.  
  797.  
  798.         Ansi Graphics:      This tells whether Omega should support ANSI        Ansi Graphics:                                                  
  799.                             graphics if they are sent by this entry.  This
  800.                             must be enabled for ANSI music and RLE graphics
  801.                             to work properly.
  802.         Replace:            This tells Omega to replace characters received        Replace:                                                           
  803.                             from this entry with different characters that
  804.                             you specify.  Simply enter the ASCII value of
  805.                             the characters to replace (a table of the ASCII
  806.                             values is located in Appendix A of this man-
  807.                             ual), and the value of the replacement charac-
  808.                             ter.  
  809.  
  810.  
  811.                         UPLOADING AND DOWNLOADING FILES                        UPLOADING AND DOWNLOADING FILES
  812.  
  813.  
  814.          Uploading is the process of sending a file from your computer to
  815.     another computer.  Downloading is the process of receiving a file from
  816.     another computer.  Before you can upload or download a file, you must
  817.     establish a protocol.  Both your computer and the computer at the other
  818.     end of the connection must be using the same protocol.  Here is a list
  819.     of the protocols Omega-Link has available, their advantages and their
  820.     disadvantages.
  821.  
  822.  
  823.          XMODEM         XMODEM
  824.  
  825.          This is the famous protocol developed for CP/M by Ward Christen-
  826.     sen.  All characters of the ASCII character set can be transmitted and
  827.     received.  This protocol uses error-checking.  Blocks received with
  828.     errors are retransmitted until success is achieved, or until the sender
  829.     or receiver gives up after ten unsuccessful attempts.
  830.  
  831.          Xmodem has two error-checking methods, or Algorithms, checksum and
  832.     CRC.  Xmodem checksum is guaranteed to be utilized by any computer that
  833.     has the Xmodem protocol, which is not true of Xmodem CRC.  However,
  834.     Xmodem CRC is far better at error detection than Xmodem checksum.  Bet-
  835.     ter than 99.99% of all errors are detected.
  836.  
  837.          Omega-Link will automatically detect and use CRC transmission, if
  838.     possible.  There are no advantages to utilizing checksum when CRC is
  839.     available.  If the computer you are downloading from gives you a choice
  840.     between checksum and CRC, pick CRC.
  841.  
  842.  
  843.          YMODEM         YMODEM
  844.  
  845.          This protocol evolved from the XMODEM CRC protocol, and has many
  846.     similarities.  The difference is that YMODEM can send data somewhat
  847.     faster and more efficiently than XMODEM because it uses a larger block
  848.     size.  The larger block size reduces overhead by reducing ACK/NAK
  849.     intervals.  This increases net throughput.
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                    -11-
  856.  
  857.  
  858.  
  859.  
  860.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  861.  
  862.  
  863.  
  864.                             FUNCTION KEYS (MACROS)                            FUNCTION KEYS (MACROS)
  865.  
  866.          One of the great strengths of Omega-Link is that you can use the
  867.     function keys to simulate any combination of keystrokes.  In addition
  868.     to being able to utilize the normal function keys, you can use the
  869.     Ctrl, Shift, and Alt with the function keys to simulate forty function
  870.     keys instead of ten.
  871.  
  872.          Also, the function key Alt-F1 is an "AUTOEXEC" macro.  That is,
  873.     the macro definition for Alt-F1 will be executed as soon as the termi-
  874.     nal mode screen appears when Omega-Link begins.  So you may find defi-
  875.     ning this macro key a great convenience to automate the start-up of
  876.     Omega.
  877.  
  878.          On top of all this, there are ten additional function (or macro,
  879.     depending on what you wish to call them) keys available by pressing the
  880.     keys "Alt-1" through "Alt-0."  These can be from a disk file any time
  881.     you wish during terminal mode by pressing Alt-J.
  882.  
  883.          The function key editor is invoked by Alt-K.  This will produce a
  884.     screen showing the current definition for the functions keys.  All 40
  885.     function key combinations cannot be shown on the screen at once.  At
  886.     the top of the screen the inclusion of the Shift, Ctrl, of Alt key will
  887.     be indicated.
  888.  
  889.          When the editor is invoked, you are given the option of modifying
  890.     a key, erasing a key, or quitting the editor and returning to the ter-
  891.     minal mode.  Pressing the "+" key will bring you to the next page, and
  892.     pressing the "-" key will turn back to the previous page.
  893.  
  894.          Function keys can be programmed to contain any messages or command
  895.     strings that you wish.  You could define the F1 key as "Welcome to
  896.     Omega-Link", or make it simulate the typing of Alt-D, 12, and the
  897.     return key.  This would call the autodial function, select entry #12
  898.     from the dialing directory, and begin dialing.  Any combination of keys
  899.     on the keyboard can be assigned to any of the 40 available function key
  900.     combinations.
  901.  
  902.          Suppose that you wish F4 to send two carriage returns.  You cannot
  903.     make the return key part of the key definition by pressing it, because
  904.     the first time that you hit it would complete the entry in the function
  905.     key editor.  For carriage return and linefeed characters, you must use
  906.     the CR/LF replacement characters defined in the Parameters Menu.  Using
  907.     the default values, two carriage returns would be programmed as "{{".
  908.     Of course, you don't include the quotation marks when using the func-
  909.     tion key editor.
  910.  
  911.          A function key definition may be entered as an ASCII code value by
  912.     flagging it with the "|" character.  For example, "|065" would tell
  913.     Omega-Link to send the ASCII code 65, which is equivalent to the char-
  914.     acter "A." If anything follows the "|" character and is not understood,
  915.     it will be sent literally.  For example, "|732" is beyond the ASCII
  916.     range, and would be sent as "|732" literally.  For a complete listing
  917.     of the special commands and of the available ASCII codes, refer to the
  918.     tables at the end of this manual.
  919.  
  920.  
  921.                                    -12-
  922.  
  923.  
  924.  
  925.  
  926.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  927.  
  928.  
  929.  
  930.          If you have defined a function key as a long sequence of key-
  931.     strokes, and you wish to interrupt the sequence before completion,
  932.     press Ctrl-Break.  This aborts the function key transmission.
  933.  
  934.  
  935.          FUNCTION KEY OPTIONS AND CONVERSION TABLES         FUNCTION KEY OPTIONS AND CONVERSION TABLES
  936.  
  937.          The following options are available in function key macros:
  938.  
  939.          |nnn         Use any ASCII code except 000.  Replace the nnn with         |nnn                                                             
  940.                       exactly 3 digits in the range of 001 - 255
  941.  
  942.          |x           Replace the x with the letter of the Omega-Link         |x                                                          
  943.                       command that you wish to execute.
  944.  
  945.          |Wnn         Wait nn seconds before continuing with the macro.         |Wnn                                                          
  946.  
  947.          |!nnn        This option allows you to enter keys that have no         |!nnn                                                         
  948.                       ASCII code.  Replace nnn with the 3 digit code from
  949.                       the table following.
  950.  
  951.          |:x          This tells Omega-Link to wait until the character         |:x                                                           
  952.                       specified by x is received before proceeding.
  953.  
  954.          |~           Send the ~ character.         |~                                
  955.  
  956.          |Innn        Slow macro speed (0 fastest - 999 slowest)         |Innn                                                  
  957.  
  958.          ~            Delay approximately 1/18th of a second.         ~                                                   
  959.  
  960.          While Omega-Link is waiting for input, anything that you type will
  961.     be sent exactly as entered.  This can be useful if you for got to put
  962.     something into your macro.   During |W waits, pressing any key termi-
  963.     nates the delay.  Timed waits are very useful for automatic log-ons to
  964.     slow systems.
  965.  
  966.          At any other time during the execution of a macro, your keyboard
  967.     entries are buffered and executed after the macro is complete.
  968.  
  969.          If you write a macro that calls itself (i.e.  you define F1 as
  970.     |!059) it could repeat itself forever.  To get out of this situation
  971.     press Ctrl-Break.  This will clear the macro and the keyboard buffer.
  972.     If the macro was sending data out, and you wish to stop the data in the
  973.     send buffer from being sent, then press Alt-(=) twice.
  974.  
  975.          See Appendix A for a table of ASCII and Extended ASCII character
  976.     codes.
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                    -13-
  988.  
  989.  
  990.  
  991.  
  992.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  993.  
  994.  
  995.  
  996.                               The Script Language                              The Script Language
  997.  
  998.          The script language is a powerful feature of Omega-Link that
  999.     allows you to program Omega-Link automate many mundane tasks.
  1000.  
  1001.          In order to write a script language program, all you have to do is
  1002.     take your favorite text editing program (even the DOS program EDLIN
  1003.     will do the job) and store the information in a file.  The file must be
  1004.     formatted as an ASCII file, with a carriage return and linefeed at the
  1005.     end of each line.  All commands can be entered in uppercase or lower
  1006.     case.  Tabs and extra spaces are ignored, so you may feel free to use
  1007.     these characters to format your text as you wish.  If the script lan-
  1008.     guage processor encounters an end-of-file character (ASCII value 26),
  1009.     it will treat act as though it has reached the end of the file.
  1010.  
  1011.          Strings can be marked with either single quotes (') or double
  1012.     quotes (").  However, please note that you must use the same type of
  1013.     quote to end a string as you used to start it.  For example:
  1014.  
  1015.          DISPLAY "ABC"      ;Display the string "ABC"
  1016.          DISPLAY 'ABC'      ;Display the string "ABC" again
  1017.          DISPLAY "ABC'DEF"  ;Display a single quote on the screen
  1018.          DISPLAY 'ABC"DEF'  ;Display a double quote on the screen
  1019.          DISPLAY "ABC'      ;Omega will flag this as an error
  1020.          DISPLAY 'ABC"      ;And will also flag this as an error
  1021.  
  1022.          Also, you can use string variables in place of quoted strings for
  1023.     all commands except the DIAL command.  A string variable begins with a
  1024.     dollar sign ($) and is followed by a single numeric digit ranging from
  1025.     0 through 9.  Here are some examples of string variables:
  1026.  
  1027.          DISPLAY $0         ;Display string variable #0
  1028.          INPUT $1, 0        ;Take a character from the keyboard
  1029.                             ; and store it in string variable #1
  1030.          DISPLAY $A         ;This is an invalid string variable
  1031.          DISPLAY $12        ;This is also an invalid variable
  1032.  
  1033.          What follows is a list of the commands available for the script
  1034.     language processor.  Anything marked as a <string> can use a string
  1035.     similar to the ones discussed previously. Anything marked as <value>
  1036.     must be an positive integer value.
  1037.  
  1038.  
  1039.                      Script Language Commands and Syntaxes                     Script Language Commands and Syntaxes
  1040.  
  1041.  
  1042. BAUDBAUD
  1043. Syntax:      BAUD <value>
  1044.  
  1045. Description: Changes the default baud rate to the value indicated.  Valid
  1046.              values are 60, 100, 110, 150, 300, 350, 400, 450, 600, 1200,
  1047.              2400, 4800, 9600, 19200, 38400.
  1048.  
  1049. Example(s):  BAUD 1200   ;Set the baud rate to 1200 baud
  1050.  
  1051.  
  1052.  
  1053.                                    -14-
  1054.  
  1055.  
  1056.  
  1057.  
  1058.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1059.  
  1060.  
  1061.  
  1062. CLSCLS
  1063. Syntax:      CLS
  1064.  
  1065. Description: Clears all text from the screen and sets the colors to the
  1066.              regular terminal mode colors.
  1067.  
  1068. Example(s):  CLS
  1069.  
  1070.  
  1071. DATADATA
  1072. Syntax:      DATA <value>
  1073.  
  1074. Description: Will set the current default number of data bits to the value
  1075.              indicated.  Valid values are 7 or 8.
  1076.  
  1077. Example(s):  DATA 7      ;Set the number of data bits to 7
  1078.  
  1079.  
  1080. DIALDIAL
  1081. Syntax:      DIAL <string>
  1082.           or DIAL <value>
  1083.  
  1084. Description: This will dial the telephone number contained in the string,
  1085.              or dial the value.  Please note that you cannot use a string
  1086.              variable in place of a string, unlike other commands.
  1087.  
  1088. Example(s):  DIAL "555-1212"   ;Dial the number 555-1212
  1089.              DIAL 3            ;Dial dialing directory entry #3
  1090.  
  1091.  
  1092. DISPLAYDISPLAY
  1093. Syntax:      DISPLAY <string>
  1094.  
  1095. Description: Displays a string to the screen beginning at the current row
  1096.              and column values.
  1097.  
  1098. Example(s):  DISPLAY "Kilroy was here!"  ;Display a literal
  1099.                                          ; string
  1100.              DISPLAY $2      ;Display string variable #2
  1101.  
  1102.  
  1103. ECHOECHO
  1104. Syntax:      ECHO ON
  1105.           or ECHO OFF
  1106.  
  1107. Description: Turns the local echo feature on or off.
  1108.  
  1109. Example(s):  ECHO ON     ;Enable ECHO
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.                                    -15-
  1120.  
  1121.  
  1122.  
  1123.  
  1124.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1125.  
  1126.  
  1127.  
  1128. ELSEELSE
  1129. Syntax:      ELSE
  1130.  
  1131. Description: This command is used in conjunction with the IF statement, and
  1132.              will execute any following commands until a ENDIF, another IF
  1133.              statement, or end of file is encountered.
  1134.  
  1135. Example(s):  IF SOUND       ;Check if sound is enabled
  1136.                DISPLAY "Sound is on."
  1137.              ELSE
  1138.                DISPLAY "Sound is off."
  1139.              ENDIF
  1140.  
  1141.  
  1142. ENDIFENDIF
  1143. Syntax:      ENDIF
  1144.  
  1145. Description: Indicates the end of an IF statement
  1146.  
  1147. Example(s):  See the example for ELSE
  1148.  
  1149.  
  1150. EXITEXIT
  1151. Syntax:      EXIT
  1152.  
  1153. Description: Tells Omega-Link to stop the execution of a script file.
  1154.  
  1155. Example(s):  EXIT  ;Stop the script file and return to Omega-Link
  1156.  
  1157.  
  1158. GOSUBGOSUB
  1159. Syntax:      GOSUB <label>
  1160.  
  1161. Description: Executes another section of a script file until a RETURN
  1162.              instruction is encountered.  When this occurs, Omega will con-
  1163.              tinue execution of the script file at the statement following
  1164.              the GOSUB.
  1165.  
  1166. Example(s):  GOSUB MARINE         ;Execute the section named "MARINE"
  1167.              DISPLAY "PART TWO{}"
  1168.              EXIT
  1169.  
  1170.              MARINE:
  1171.              DISPLAY "PART ONE{}"
  1172.              RETURN               ;Display "PART TWO" with carriage return
  1173.                                   ; and linefeed
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.                                    -16-
  1186.  
  1187.  
  1188.  
  1189.  
  1190.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1191.  
  1192.  
  1193.  
  1194. GOTOGOTO
  1195. Syntax:      GOTO <label>
  1196.  
  1197. Description: Continue execution of a script file in another portion.
  1198.  
  1199. Example(s):  GOTO PART_ONE        ;Continue execution at PART_ONE
  1200.              PART_TWO:
  1201.              DISPLAY "PART TWO{}"
  1202.              EXIT
  1203.  
  1204.              PART_ONE:
  1205.              DISPLAY "PART ONE{}"  ;Display "PART TWO" with carriage return
  1206.                                    ; and linefeed
  1207.              GOTO PART_TWO         ;Continue execution at PART_TWO
  1208.  
  1209.  
  1210. GRAPHICSGRAPHICS
  1211. Syntax:      GRAPHICS ON
  1212.           or GRAPHICS OFF
  1213.  
  1214. Description: "GRAPHICS ON" enables ANSI graphics, while "GRAPHICS OFF" dis-
  1215.              ables ANSI graphics.
  1216.  
  1217. Example(s):  GRAPHICS ON   ;Enable ANSI graphics
  1218.              GRAPHICS OFF  ;Disables ANSI graphics
  1219.  
  1220.  
  1221. HANGUPHANGUP
  1222. Syntax:      HANGUP
  1223.  
  1224. Description: Hangs the modem up.
  1225.  
  1226. Example(s):  HANGUP
  1227.  
  1228.  
  1229. IFIF
  1230. Syntax:      IF <expression>
  1231.  
  1232. Description: Will execute any commands afterwards only if <expression> is
  1233.              true until an ENDIF, ELSE, or end of file is encountered.
  1234.  
  1235.              <expression> can take many forms.  They are:
  1236.  
  1237.         SOUND               True if sound is enabled.        SOUND                                        
  1238.         LINEFEEDS           True if linefeeds are enabled.        LINEFEEDS                                         
  1239.         GRAPHICS            True if ANSI graphics are enabled.        GRAPHICS                                              
  1240.         ECHO                True if echo is enabled.        ECHO                                        
  1241.         WAITFOR             True if previous WAITFOR did not time out.        WAITFOR                                                       
  1242.         CAPTURE             True if the text capture feature is enabled.        CAPTURE                                                         
  1243.         LINKED              True the script file was executed as a result        LINKED                                                           
  1244.                             of dialing directory entry executing the file
  1245.                             because of successful connection.
  1246.         TIMEOUT             True if a timeout occurred.        TIMEOUT                                        
  1247.  
  1248.  
  1249.  
  1250.  
  1251.                                    -17-
  1252.  
  1253.  
  1254.  
  1255.  
  1256.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1257.  
  1258.  
  1259.  
  1260.         CONNECTED           True if Omega-Link successfully connected with        CONNECTED                                                         
  1261.                             a host system.  Both CONNECTED and NOTCONNECTED
  1262.                             will be false if no number was dialed.
  1263.         NOTCONNECTED        True if Omega-Link did not successfully connect        NOTCONNECTED                                                       
  1264.                             with a host system.  Both this and CONNECTED
  1265.                             will be false if no number was dialed.
  1266.         RLE                 True if RLE graphics are enabled.        RLE                                                  
  1267.         MUSIC               True if ANSI Music is enabled.        MUSIC                                             
  1268.  
  1269.         Also, there are string comparison operators.  Their syntax is:
  1270.         $n <operator> <string>.  String can be a quoted string or another
  1271.         string variable.  The valid operators are:
  1272.  
  1273.         <                   Less-than        <                            
  1274.         =                   Equals        =                         
  1275.         >                   Greater-than        >                               
  1276.         <= or =<            Less-than or Equals        <=    =<                               
  1277.         >= or =>            Greater-than or Equals        >=    =>                                  
  1278.         <> or ><            Greater-than or Less-than        <>    ><                                     
  1279.  
  1280.          Some notes on the IF statement are as follows:
  1281.  
  1282.        o "Nested" IFs are not allowed.  For example:
  1283.          IF <expression>
  1284.          IF <expression>
  1285.          ENDIF
  1286.          ENDIF
  1287.  
  1288.          Will not work as you would expect.  Omega-Link will return an
  1289.     error because there are too many ENDIFs.
  1290.  
  1291.          o If <expression> is not true, and there is an ELSE statement fol-
  1292.     lowing the IF statement, commands following the ELSE will be executed.
  1293.     See the ELSE command for further details.
  1294.          o An ENDIF command will signal the end of an IF (and any corre-
  1295.     sponding ELSE statements).  Anything following an ENDIF will be
  1296.     executed regardless of whether <expression> executed regardless of
  1297.     whether <expression> in the IF statement was true or not.
  1298.          o Reaching the end of a file will act as an ENDIF.  If there is an
  1299.     ENDIF at the end of the file, no problems will result.
  1300.  
  1301. Example(s):  IF SOUND           ;Example number 1
  1302.                 DISPLAY "Sound is ON.{}"
  1303.              ELSE
  1304.                 DISPLAY "Sound is OFF.{}"
  1305.              ENDIF
  1306.  
  1307.              IF $0 = "A"        ;Example number 2
  1308.                 DISPLAY 'String number 0 equals an "A."'
  1309.              ENDIF
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                                    -18-
  1318.  
  1319.  
  1320.  
  1321.  
  1322.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1323.  
  1324.  
  1325.  
  1326. INPUTINPUT 
  1327. Syntax:      INPUT <string>, <value>
  1328.  
  1329. Description: This will take a series of characters from the keyboard for
  1330.              <value> number of characters, or until ENTER is pressed, and
  1331.              place them in <string>.  Note that if <value> is equal to 0,
  1332.              Omega-Link will just take a character from the keyboard as
  1333.              soon as one is pressed, without waiting for the ENTER key.
  1334.  
  1335. Example(s):  INPUT $2, 10
  1336.  
  1337.  
  1338. LINEFEEDSLINEFEEDS
  1339. Syntax:      LINEFEEDS ON
  1340.           or LINEFEEDS OFF
  1341.  
  1342. Description: "LINEFEEDS ON" will tell Omega that it should display a line
  1343.              feed with every carriage return received while "LINEFEEDS OFF"
  1344.              will tell Omega that it should NOT display a linefeed with
  1345.              every carriage return received.
  1346.  
  1347. Example(s):  LINEFEEDS OFF    ;Disable linefeeds
  1348.  
  1349.  
  1350. LOCATELOCATE
  1351. Syntax:      LOCATE <row value>, <column value>
  1352.           or LOCATE <row value>
  1353.           or LOCATE ,<column value>
  1354.  
  1355. Description: "LOCATE" will locate the cursor at the row and/or column num-
  1356.              ber.  If the column number is omitted, LOCATE will leave the
  1357.              cursor at the current column, and simply re-locate to the spe-
  1358.              cified row.  Likewise, if the row value is omitted, the cursor
  1359.              will stay in the current row, and be re-located to the speci-
  1360.              fied column.
  1361.  
  1362.              Valid values for <row value> are 0-23, and valid values for
  1363.              <column value> are 0-79.
  1364.  
  1365. Example(s):  LOCATE 0,0     ;Locate the cursor at the top corner of the
  1366.                             ; screen
  1367.              LOCATE 23      ;Place the cursor on the bottom line
  1368.              LOCATE ,79     ;Place the cursor the rightmost column
  1369.  
  1370.  
  1371. MUSICMUSIC
  1372. Syntax:      MUSIC ON
  1373.           or MUSIC OFF
  1374.  
  1375. Description: Will enable or disable ANSI music.  Please note that ANSI
  1376.              Graphics must be enabled for ANSI music to work properly.
  1377.  
  1378. Example(s):  MUSIC OFF      ;Disable ANSI music
  1379.  
  1380.  
  1381.  
  1382.  
  1383.                                    -19-
  1384.  
  1385.  
  1386.  
  1387.  
  1388.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1389.  
  1390.  
  1391.  
  1392. PARITYPARITY
  1393. Syntax:      PARITY ODD
  1394.           or PARITY EVEN
  1395.           or PARITY NONE
  1396.  
  1397. Description: Will set the parity to ODD, EVEN, or NONE.
  1398.  
  1399. Example(s):  PARITY NONE    ;Set for no parity
  1400.  
  1401.  
  1402. PAUSEPAUSE
  1403. Syntax:      PAUSE <value>
  1404.  
  1405. Description: Will pause for <value> number of seconds.
  1406.  
  1407. Example(s):  PAUSE 3        ;Pause for three seconds
  1408.  
  1409.  
  1410. PLAYPLAY
  1411. Syntax:      PLAY <string>
  1412.  
  1413. Description: This is a powerful command that allows you to play music from
  1414.              the speaker of your computer.  <string> is a series of com-
  1415.              mands that are as follows:
  1416.  
  1417.         O<n>                Changes to octave number <n>.  The default        O<n>                                                          
  1418.                             octave is 4.  There are seven octaves ranging
  1419.                             from 0 through 6.
  1420.         <                   Decrement the octave number.  Octaves are not        <                                                                
  1421.                             decremented if the octave value is already
  1422.                             equal to 0.
  1423.         >                   Increments the octave number.  Octaves are not        >                                                                 
  1424.                             incremented if the octave value is already
  1425.                             equal to 6.
  1426.         A-G                 Plays a note in the range A-G.  An example        A-G                                                           
  1427.                             would be "C," which would play the note "C" of
  1428.                             the current octave.
  1429.         N<n>                Plays note number <n>.  The valid range for <n>        N<n>                                                               
  1430.                             is 0 through 84.  0 indicates a quarter rest.
  1431.         L<n>                Sets the default length of each note played.  1        L<n>                                                               
  1432.                             would indicate four beats per quarter note, 2
  1433.                             would indicate 2 beats per quarter note, etc. .
  1434.                             . . .  The default value is 1.
  1435.         MN                  Sets to normal music mode, so that each note is        MN                                                                 
  1436.                             played for 7/8 of its length.  This is the
  1437.                             default mode.
  1438.         ML                  Sets to legato music mode, so that each note is        ML                                                                 
  1439.                             played for its full length.
  1440.         MS                  Sets to staccato music mode, so that each note        MS                                                                
  1441.                             is played for 3/4 of its normal length.
  1442.         P<n>                Pauses, with <n> ranging from 1-64, with 1        P<n>                                                          
  1443.                             indicating a full rest, 2 indicating a half
  1444.                             rest, etc. . . . .
  1445.         T<n>                Sets the tempo of the music, with <n> indicat-        T<n>                                                              
  1446.                             ing the metronome speed for each quarter note.
  1447.  
  1448.  
  1449.                                    -20-
  1450.  
  1451.  
  1452.  
  1453.  
  1454.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1455.  
  1456.  
  1457.  
  1458.                             <n> may range from 32 through 255.  The default
  1459.                             is 120.
  1460.         # or +              Follows a note to indicate that it is a sharp.        # or +                                                            
  1461.         -                   Follows a note to indicate that it is a flat.        -                                                                
  1462.         <n>                 Follows a note to indicate its length.  1 would        <n>                                                                
  1463.                             correspond to a whole note, 2 to a half note,
  1464.                             etc. . . . .
  1465.         .                   Indicates a dotted note, i.e.: a note is to        .                                                              
  1466.                             play 3/2 times the length it would normally
  1467.                             play.
  1468.  
  1469. NOTES:       o Multiple sharps and flats are ignored
  1470.              o Multiple dots are ignored
  1471.  
  1472. Example(s):  PLAY "T185O3G2MSDEMNDP2MSD8D8EMND" ;Play Handel's "Messiah"
  1473.  
  1474.  
  1475. RECEIVERECEIVE
  1476. Syntax:      RECEIVE <string>, <value>
  1477.  
  1478. Description: Will take <value> number of characters from the modem and
  1479.              place them in <string>.  Receive will also stop if a carriage
  1480.              return is received or a timeout occurs.  If <value> equals 0,
  1481.              receive will take the next incoming character, whatever it may
  1482.              be.
  1483.  
  1484. Example(s):  RECEIVE $2, 3  ;Will take 3 characters from modem and put them
  1485.                             ; into string number 2
  1486.  
  1487.  
  1488. RETURNRETURN
  1489. Syntax:      RETURN
  1490.  
  1491. Description: Will continue execution at the statement following the last
  1492.              GOSUB statement that was executed.  If no GOSUBs were encoun-
  1493.              tered prior to executing the "RETURN," the script file execu-
  1494.              tion will be terminated.
  1495.  
  1496. Example(s):  See the example for GOSUB
  1497.  
  1498.  
  1499. RLERLE
  1500. Syntax:      RLE ON
  1501.           or RLE OFF
  1502.  
  1503. Description: Will enable or disable RLE graphics.  Please note that in
  1504.              order for RLE graphics to work, ANSI graphics must also be
  1505.              enabled.
  1506.  
  1507. Example(s):  RLE OFF           ;Disable RLE graphics
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.                                    -21-
  1516.  
  1517.  
  1518.  
  1519.  
  1520.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1521.  
  1522.  
  1523.  
  1524. SENDSEND 
  1525. Syntax:      SEND <string>
  1526.  
  1527. Description: Will send <string> to the modem.
  1528.  
  1529. Example(s):  SEND "This sentence is false."
  1530.  
  1531.  
  1532. SOUNDSOUND
  1533. Syntax:      SOUND ON
  1534.           or SOUND OFF
  1535.  
  1536. Description: Enables or disables the SOUND option of Omega-Link.
  1537.  
  1538. Example(s):  SOUND ON          ;Turn the sound option off
  1539.  
  1540.  
  1541. STOPSTOP
  1542. Syntax:      STOP <n>
  1543.  
  1544. Description: Set the number of stop bits.  Valid values for <n> are 1 or 2.
  1545.  
  1546. Example(s):  STOP 2            ;Sets the number of stop bits to 2
  1547.  
  1548.  
  1549. TIMEOUTTIMEOUT
  1550. Syntax:      TIMEOUT = <value>
  1551.  
  1552. Description: Set the length (in seconds) before a timeout will occur.  A
  1553.              timeout is a value that is turned on if no input is received
  1554.              by a command for <value> number of seconds.
  1555.  
  1556. Example(s):  TIMEOUT [=] 3     ;Set the timeout value to 3 seconds
  1557.  
  1558.  
  1559. WAITFORWAITFOR
  1560. Syntax:      WAITFOR <string>
  1561.  
  1562. Description: Waits for <string> to be received from the modem before conti-
  1563.              nuing the execution of the script file.
  1564.  
  1565. Example(s):  WAITFOR "Enter your password:"  ;Will pause until this string
  1566.                                              ; is received.
  1567.  
  1568.  
  1569. LABELSLABELS
  1570. Syntax:      <label name>:
  1571.  
  1572. Description: A label is used as a marker for various commands such as GOSUB
  1573.              and GOTO.  Valid label names are any alphanumeric characters
  1574.              and must be followed by a ":."
  1575.  
  1576. Example(s):  LABEL_1:
  1577.  
  1578.  
  1579.  
  1580.  
  1581.                                    -22-
  1582.  
  1583.  
  1584.  
  1585.  
  1586.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1587.  
  1588.  
  1589.  
  1590. MULTIPLE COMMANDS PER LINEMULTIPLE COMMANDS PER LINE
  1591. Syntax:      <command> | <command>
  1592.  
  1593. Description: The "|" character is used to allow you to have two commands on
  1594.              the same line.
  1595.  
  1596. Example:     LOCATE 0,0 | DISPLAY "Welcome to Omega-Link"
  1597.  
  1598.  
  1599. COMMENTSCOMMENTS
  1600. Syntax:      ;<comments>
  1601.  
  1602. Description: The ";" is used to indicate that the rest of a line is com
  1603.              posed of comments.  Anything following the ";" will be
  1604.              ignored.  Therefore, if you have any commands following a ";,"
  1605.              they will be ignored.  If a ";" is contained in a string, it
  1606.              will be treated as part of the string and will be displayed.
  1607.  
  1608. Example(s):  DISPLAY "HELLO" ;This is a comment
  1609.              DISPLAY "THERE" ;LOCATE 2,2 <-- "LOCATE" IS ALSO A COMMENT
  1610.              DISPLAY ";" | LOCATE 2,2 ;Display a semicolon and locate the
  1611.                                       ; cursor at row 2, column 2
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.                                    -23-
  1648.  
  1649.  
  1650.  
  1651.  
  1652.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1653.  
  1654.  
  1655.  
  1656.                                   Appendix A                                  Appendix A
  1657.  
  1658.                    ASCII and Extended ASCII character codes                   ________________________________________
  1659.  
  1660.  
  1661.          ASCII Character Codes         ASCII Character Codes
  1662.  
  1663.          These are the codes to be used with the |nnn option of the func-
  1664.     tion key macros.
  1665.  
  1666.      Code Function     Code Function       Code Function      Code Function
  1667.      ---- --------     ---- --------       ---- --------      ---- --------
  1668.      000  NULL         008  BACK SPACE     016  DLE           024   CAN
  1669.      001  SOH          009  HORIZ TAB      017  DC1 (XON)     025   EM
  1670.      002  STX          010  LINE FEED      018  DC2           026   SUB
  1671.      003  ETX          011  VERT TAB       019  DC3 (XOFF)    027   ESC
  1672.      004  EOT          012  FORM FEED      020  DC4           028   FS
  1673.      005  ENQ          013  CR             021  NAK           029   GS
  1674.      006  ACK          014  SHIFT OUT      022  SYN           030   RS
  1675.      007  BELL         015  SHIFT IN       023  ETB           031   US
  1676.  
  1677.         Code Char  Code Char  Code Char  Code Char  Code Char  Code Char
  1678.         ---- ----  ---- ----  ---- ----  ---- ----  ---- ----  ---- ----
  1679.          032 SPACE  048   0    064   @    080   P    096   `    112   p
  1680.          033   !    049   1    065   A    081   Q    097   a    113   q
  1681.          034   "    050   2    066   B    082   R    098   b    114   r
  1682.          035   #    051   3    067   C    083   S    099   c    115   s
  1683.          036   $    052   4    068   D    084   T    100   d    116   t
  1684.          037   %    053   5    069   E    085   U    101   e    117   u
  1685.          038   &    054   6    070   F    086   V    102   f    118   v
  1686.          039   '    055   7    071   G    087   W    103   g    119   w
  1687.          040   (    056   8    072   H    088   X    104   h    120   x
  1688.          041   )    057   9    073   I    089   Y    105   i    121   y
  1689.          042   *    058   :    074   J    090   Z    106   j    122   z
  1690.          043   +    059   ;    075   K    091   [    107   k    123   {
  1691.          044   ,    060   <    076   L    092   \    108   l    124   |
  1692.          045   -    061   =    077   M    093   ]    109   m    125   }
  1693.          046   .    062   >    078   N    094   ^    110   n    126   ~
  1694.          047   /    063   ?    079   O    095   _    111   o    127   
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.                                    -24-
  1714.  
  1715.  
  1716.  
  1717.  
  1718.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1719.  
  1720.  
  1721.  
  1722.                         Extended ASCII Character Codes                        Extended ASCII Character Codes
  1723.  
  1724.          These are the codes to be used with the |!nnn option of the func-
  1725.     tion key macros.
  1726.  
  1727.  
  1728.           Code Keypressed      Code Keypressed        Code  Keypressed
  1729.           ---- ----------      ---- ----------        ----  ----------
  1730.           59    F1             94   Ctrl-F1           120   Alt-1
  1731.           60    F2             95   Ctrl-F2           121   Alt-2
  1732.           61    F3             96   Ctrl-F3           122   Alt-3
  1733.           62    F4             97   Ctrl-F4           123   Alt-4
  1734.           63    F5             98   Ctrl-F5           124   Alt-5
  1735.           64    F6             99   Ctrl-F6           125   Alt-6
  1736.           65    F7             100  Ctrl-F7           126   Alt-7
  1737.           66    F8             101  Ctrl-F8           127   Alt-8
  1738.           67    F9             102  Ctrl-F9           128   Alt-9
  1739.           68    F10            103  Ctrl-F10          129   Alt-0
  1740.  
  1741.  
  1742.           Code Keypressed      Code Keypressed        Code  Keypressed
  1743.           ---- ----------      ---- ----------        ----  ----------
  1744.           84   Shift-F1        104  Alt-F1            3     Null (Ctrl-2)
  1745.           85   Shift-F2        105  Alt-F2            15    Shift-Tab
  1746.           86   Shift-F3        106  Alt-F3            71    Home
  1747.           87   Shift-F4        107  Alt-F4            72    Up arrow
  1748.           88   Shift-F5        108  Alt-F5            73    PgUp
  1749.           89   Shift-F6        109  Alt-F6            75    Left arrow
  1750.           90   Shift-F7        110  Alt-F7            77    Right arrow
  1751.           91   Shift-F8        111  Alt-F8            79    End
  1752.           92   Shift-F9        112  Alt-F9            80    Down arrow
  1753.           93   Shift-F10       113  Alt-F10           81    PgDn
  1754.  
  1755.  
  1756.          Code Keypressed      Code Keypressed        Code  Keypressed
  1757.          ---- ----------      ---- ----------        ----  ----------
  1758.          30   Alt-A           49   Alt-N             82    Insert
  1759.          48   Alt-B           24   Alt-O             83    Delete
  1760.          46   Alt-C           25   Alt-P             114   Echo
  1761.          32   Alt-D           16   Alt-Q             115   Ctrl-Left-arrow
  1762.          18   Alt-E           19   Alt-R             116   Ctrl-Right-arrow
  1763.          33   Alt-F           31   Alt-S             117   Ctrl-End
  1764.          34   Alt-G           20   Alt-T             118   Ctrl-PgDn
  1765.          35   Alt-H           22   Alt-U             119   Ctrl-Home
  1766.          23   Alt-I           47   Alt-V             130   Alt-Hyphen
  1767.          36   Alt-J           17   Alt-W             131   Alt-Equals
  1768.          37   Alt-K           45   Alt-X             132   Ctrl-PgUp
  1769.          38   Alt-L           21   Alt-Y
  1770.          50   Alt-M           44   Alt-Z
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.                                    -25-
  1780.  
  1781.  
  1782.  
  1783.  
  1784.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1785.  
  1786.  
  1787.  
  1788.                                   Appendix B                                  Appendix B
  1789.  
  1790.                                    Glossary                                   ________
  1791.  
  1792.  
  1793.          Algorithms - A series of steps for accomplishing a task.         Algorithms                                              
  1794.  
  1795.          Alt command - A command selected by holding the "Alt" key down on         Alt command                                                      
  1796.     your keyboard and simultaneously pressing the corresponding key of the
  1797.     option you wish to select.
  1798.  
  1799.          ANSI - A special standard that is used among some computers which         ANSI                                                             
  1800.     allows colors and cursor positioning, in addition to many other fea-
  1801.     tures.
  1802.  
  1803.          ASCII - An acronym for "American Standard for Information Inter         ASCII                                                          
  1804.     change." It is a set of standards agreed upon that allow computers to
  1805.     exchange information and know what the information means, thus allowing
  1806.     the letter "A" to be known as that letter on two entirely different
  1807.     computers.
  1808.  
  1809.          Baud Rate - The speed at which data is transferred between two         Baud Rate                                                     
  1810.     computers.  The higher the baud rate, the faster the data is sent.
  1811.  
  1812.          BBS - Acronym for "Bulletin Board Service."  It is a service         BBS                                                         
  1813.     provided on another computer which offers you a variety of special
  1814.     functions such as exchanging programs and messages with other computer
  1815.     users.
  1816.  
  1817.          Bit - A piece of information that represents a condition, either         Bit                                                             
  1818.     on or off (1 or 0, yes or no).
  1819.  
  1820.          Buffer - A special area reserved in your computer's memory that is         Buffer                                                            
  1821.     used by Omega-Link to store information that cannot be processed at the
  1822.     moment.  It improves the performance and reliability of the program.
  1823.  
  1824.          Byte - A value represented by eight bits.         Byte                                     
  1825.  
  1826.          Carriage Return - This is usually abbreviated as "CR."  It is a         Carriage Return                                                
  1827.     special character that moves the cursor to the beginning of a line on
  1828.     the screen.  It is also another name given to the enter key on your
  1829.     keyboard.
  1830.  
  1831.          Carrier - A signal that indicates that your modem is indeed commu-         Carrier                                                           
  1832.     nicating with another modem.
  1833.  
  1834.          CD - An abbreviation for "Change Directory."  It is the ability to         CD                                                                
  1835.     change the current path that DOS is using to access files.
  1836.  
  1837.          Character - A space, a number, alphabetic letter, etc.  .  .  .         Character                                                      
  1838.  
  1839.          Checksum - A method used in certain protocols used to verify that         Checksum                                                         
  1840.     information was sent/received correctly.
  1841.  
  1842.          Configuration - How Omega-Link is set up for you.         Configuration                                    
  1843.  
  1844.  
  1845.                                    -26-
  1846.  
  1847.  
  1848.  
  1849.  
  1850.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1851.  
  1852.  
  1853.  
  1854.  
  1855.          CRC - Another way of verifying that information was sent cor-         CRC                                                          
  1856.     rectly.  This differs from checksum in that it is far more reliable in
  1857.     catching errors.
  1858.  
  1859.          Cursor - The mark on the screen that indicates where whatever         Cursor                                                       
  1860.     appears will be displayed.
  1861.  
  1862.          Data Bits - The number of bits per group of information that are         Data Bits                                                       
  1863.     actually used for transferring information.
  1864.  
  1865.          Default Drive - The drive that is currently active.         Default Drive                                      
  1866.  
  1867.          Download - The process of receiving a file from another computer.         Download                                                         
  1868.  
  1869.          "Dumb" terminal - Called "dumb" because it only displays what the         "Dumb" terminal                                                  
  1870.     other computer sends to you, and sends to the other computer whatever
  1871.     you type.
  1872.  
  1873.          Echo - The process of repeating characters that are sent to a         Echo                                                         
  1874.     computer back to the computer that sent the characters.
  1875.  
  1876.          Esc - A key on your keyboard (it is an abbreviation for         Esc                                                    
  1877.     "Escape.").
  1878.  
  1879.          File Names - The name(s) given to a file stored on a disk of your         File Names                                                       
  1880.     computer.
  1881.  
  1882.          File System - A special feature of Omega-Link that allows you to         File System                                                     
  1883.     handle files on your disks, with abilities that equal or rival those of
  1884.     MSDOS.
  1885.  
  1886.          Flush - To clear a buffer of information that is currently stored         Flush                                                            
  1887.     in it.
  1888.  
  1889.          Function Key - A set of keys on the keyboard that begin with the         Function Key                                                    
  1890.     letter "F" and are followed by a number.
  1891.  
  1892.          Host - The computer the you are communicating with, usually a         Host                                                         
  1893.     Bulletin Board Service (B.B.S.).
  1894.  
  1895.          Initialize - A way of setting-up a device that is hooked to your         Initialize                                                      
  1896.     computer.
  1897.  
  1898.          Linefeed - A special character that tells the cursor to move down         Linefeed                                                         
  1899.     a line on the screen.  Some host computers will send the line feeds,
  1900.     and others won't.  Omega-Link provides an option for both circum-
  1901.     stances.
  1902.  
  1903.          Macro - A command that allows you to emulate a series of key         Macro                                                       
  1904.     strokes that you would normally type (i.e.  a means of making your com-
  1905.     puter into a phantom typist).  This allows you to define your own cus-
  1906.     tomized commands for use in Omega-Link.
  1907.  
  1908.  
  1909.  
  1910.  
  1911.                                    -27-
  1912.  
  1913.  
  1914.  
  1915.  
  1916.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1917.  
  1918.  
  1919.  
  1920.          Menu - A list of options available to you at a given moment.  It         Menu                                                            
  1921.     is just like the menu in a restaurant, showing what you may select.
  1922.  
  1923.          Null - An empty character.         Null                      
  1924.  
  1925.          Parameters - Options that are available in Omega-Link, such as         Parameters                                                    
  1926.     modem commands, baud rates, etc.  .  .  .
  1927.  
  1928.          Parity - A special bit that is used on some computer systems to         Parity                                                         
  1929.     verify that information is sent correctly, and has not been garbled.
  1930.  
  1931.          Path - Information used by DOS to specify where a file is stored         Path                                                            
  1932.     on a disk relative to other files.
  1933.  
  1934.          Port - A place on the computer where an accessory device, usually         Port                                                             
  1935.     a modem, is hooked.
  1936.  
  1937.          Print Screen - This copies whatever is on the screen at the moment         Print Screen                                                      
  1938.     to a file, usually the printer (which MSDOS treats as a special file).
  1939.  
  1940.          Protocol - A method of uploading or downloading files between two         Protocol                                                         
  1941.     computers.
  1942.  
  1943.          Pulse Dialing - Another way that telephone numbers are dialed.         Pulse Dialing                                                 
  1944.     This is slower, and almost all telephone lines have the ability to dial
  1945.     in pulse mode.
  1946.  
  1947.          RLE graphics - A special standard set up to send pictures over the         RLE graphics                                                      
  1948.     telephone lines.  Originally used to send weather maps, but now have
  1949.     gained other uses such as exchanging artwork.
  1950.  
  1951.          Scrollback - This allows you to go back to view and/or edit what         Scrollback                                                      
  1952.     has disappeared off of the top of your screen.
  1953.  
  1954.          Serial Line - A method of sending information one bit at a time.         Serial Line                                                     
  1955.     All modems speak to each other using serial methods.
  1956.  
  1957.          Session Capture - It saves all communications that you receive and         Session Capture                                                   
  1958.     send with another computer in a disk file.
  1959.  
  1960.          Shell - The process of leaving Omega-Link to run another program,         Shell                                                            
  1961.     and then returning to back to Omega-Link, with things remembered as
  1962.     they were before you left.
  1963.  
  1964.          Split Screen - Breaking the screen into two sections: one which         Split Screen                                                   
  1965.     shows information as it is being received from the host system, and the
  1966.     other half which is used to display what you type.  Useful for things
  1967.     such as chatting with a sysop.
  1968.  
  1969.          Status Line - A line on the bottom of your screen that shows what         Status Line                                                      
  1970.     is happening in the program, such as how long you have been on a board,
  1971.     current date and time, whether the caps lock is on, displaying mes-
  1972.     sages, etc.  .  .  .
  1973.  
  1974.          String - A group of characters.         String                         
  1975.  
  1976.  
  1977.                                    -28-
  1978.  
  1979.  
  1980.  
  1981.  
  1982.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  1983.  
  1984.  
  1985.  
  1986.          Stop Bits - Special bits to separate groups of information as they         Stop Bits                                                         
  1987.     are sent over the phone lines.
  1988.  
  1989.          Strip/Convert - The ability to take a character that is sent to         Strip/Convert                                                  
  1990.     you by another computer, and change it to a different character as it
  1991.     comes in over the lines.
  1992.  
  1993.          Subdirectory - Information used by DOS.  It is part of a path to a         Subdirectory                                                      
  1994.     given group of files.
  1995.  
  1996.          Sustained Break - A special signal used for communicating with         Sustained Break                                               
  1997.     another computer whose purpose varies depending on your host system
  1998.     (quite often it is a way of saying "STOP!")
  1999.  
  2000.          Sysop - An acronym for SYStem OPerator.  This is the person that         Sysop                                                           
  2001.     runs and maintains the host system that you are calling.
  2002.  
  2003.          Terminal Mode - A way that the software sets up your computer so         Terminal Mode                                                   
  2004.     that it may communicate with another computer.
  2005.  
  2006.          Toggle - A switch that is either on or off, yes or no.         Toggle                                                
  2007.  
  2008.          Tone Dialing- A way that telephone numbers are dialed.  This is a         Tone Dialing                                                     
  2009.     feature provided to you by the telephone company.
  2010.  
  2011.          Upload - The process of sending a file to another computer.         Upload                                                     
  2012.  
  2013.          Window - A section of the screen that is marked-off for special         Window                                                         
  2014.     display information.
  2015.  
  2016.          Xoff - A special signal sent by a computer that tells the other         Xoff                                                           
  2017.     computer it should not send information until a "Xon" is sent.
  2018.  
  2019.          Xon - A special signal sent by a computer that tells the other         Xon                                                           
  2020.     computer it may send information.  This is the opposite of "Xoff."
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.                                    -29-
  2044.  
  2045.  
  2046.  
  2047.  
  2048.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  2049.  
  2050.  
  2051.  
  2052.                                   Appendix C                                  Appendix C
  2053.  
  2054.          Here is a brief list of some problems you may encounter while
  2055.     using Omega-Link, and some suggests as to what you should do about
  2056.     them:
  2057.  
  2058. Problem:     Shift-PrtSc is not printing your RLE picture correctly.Problem:                                                            
  2059. Suggestion:  For this command to work, you must have a graphics driverSuggestion:                                                           
  2060.              installed before you execute Omega-Link. There is one with
  2061.              most versions of DOS.  However, some printers come with their
  2062.              own graphics drivers.  You should consult your printer man-
  2063.              ual(s) and/or your DOS manual for more information.
  2064.  
  2065. Problem:     Every character you type appears twice on the screen.Problem:                                                          
  2066. Suggestion:  Press Alt-E to disable local echo.Suggestion:                                    
  2067.  
  2068. Problem:     Whatever you type does not appear on the screen.Problem:                                                     
  2069. Suggestion:  Press Alt-E to enable local echo.Suggestion:                                   
  2070.  
  2071. Problem:     Lines of text are printed on top of one another.Problem:                                                     
  2072. Suggestion:  Press Shift-Tab to enable Omega-Link to display a linefeedSuggestion:                                                            
  2073.              with every carriage return that is displayed.
  2074.  
  2075. Problem:     All lines of text are double spaced.Problem:                                         
  2076. Suggestion:  Press Shift-Tab to stop Omega-Link from displaying aSuggestion:                                                      
  2077.              linefeed with every carriage return that is displayed.
  2078.  
  2079. Problem:     All text is displayed as garbage. Problem:                                       
  2080. Suggestion:  Confirm that the number of data bits, stop bits, parity value,Suggestion:                                                                
  2081.              and modem speed are set correctly for the computer with which
  2082.              you are connected.  Also, make sure that ANSI graphics are
  2083.              enabled if they need to be for the system that you are call-
  2084.              ing.
  2085.  
  2086. Problem:     Your modem is not recognizing anything that is sent to it. Problem:                                                                
  2087. Suggestion:  Make sure that the baud rate and com port values are set cor-Suggestion:                                                               
  2088.              rectly.  Also, make sure that all modem commands are defined
  2089.              correctly for the modem that you are using.
  2090.  
  2091. Problem:     Any uploads or downloads are terminated before they should beProblem:                                                                  
  2092.              terminated.
  2093. Suggestion:  Several things can cause this to occur.  If you do not tellSuggestion:                                                             
  2094.              Omega to download quickly enough after being told to do so by
  2095.              the host system, the host system may terminate the file trans-
  2096.              fer.  Usually you have in the neighborhood of 30-40 seconds to
  2097.              enable a download with Omega-Link before most host systems
  2098.              will stop trying to transfer a file.
  2099.  
  2100.              Another thing that might cause this to occur is if the infor-
  2101.              mation is being garbled by the telephone lines or if the host
  2102.              system is not recognizing the transfer correctly.
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.                                    -30-
  2110.  
  2111.  
  2112.  
  2113.  
  2114.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  2115.  
  2116.  
  2117.  
  2118. Problem:     On-line RLE pictures are not appearing correctly.Problem:                                                      
  2119. Suggestion:  There can be several causes for this problem.  One problem maySuggestion:                                                                
  2120.              be that you do not have on-line RLE graphics enabled (make
  2121.              sure that ANSI graphics are enabled also for the on-line RLE
  2122.              graphics to work).
  2123.  
  2124.              Another cause may be if you are using an EGA (or EGA compa-
  2125.              tible) display card.  Some EGA cards will lose characters from
  2126.              the modem when they change to graphics mode from text mode.
  2127.              If you think this is the problem, enable "XON/XOFF" in the
  2128.              "Communications Parameters" portion of the Parameters menu,
  2129.              and make sure that your host system supports XON/XOFF charac-
  2130.              ters.
  2131.  
  2132.              Finally, this problem could be due to line noise.
  2133.  
  2134. Problem:     ANSI Music will not play. Problem:                               
  2135. Suggestion:  Make sure that the ANSI music option (Alt-O) is enabled.  InSuggestion:                                                              
  2136.              order for the ANSI music option to be enabled, the ANSI-
  2137.              graphics option (Alt-G) should also be enabled.
  2138.  
  2139. Problem:     ANSI Graphics are not appearing correctly.Problem:                                               
  2140. Suggestion:  Make sure that the ANSI graphics option is enabled.  AnotherSuggestion:                                                              
  2141.              cause may be that line noise is garbling text that you are
  2142.              being sent.
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.                                    -31-
  2176.  
  2177.  
  2178.  
  2179.  
  2180.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  2181.  
  2182.  
  2183.  
  2184.                                   Appendix D                                  Appendix D
  2185.  
  2186.                          Commands for Editing Strings                         ____________________________
  2187.  
  2188.         In many menus displayed by Omega-Link, you will need to be able to
  2189.     edit strings (such as the modem initialization string).  Omega-Link has
  2190.     an advanced editor designed to make these changes easier.  Here is a
  2191.     list of keystrokes that you can press while editing a string, and what
  2192.     these keystrokes do:
  2193.  
  2194.         Up-Arrow:           This will bring you to the field to edit that        Up-Arrow:                                                        
  2195.                             is located above the field you are located at
  2196.                             currently.
  2197.  
  2198.         Down-Arrow:         Will bring you to the field located below the        Down-Arrow:                                                      
  2199.                             one you are located at currently.
  2200.  
  2201.         Left-Arrow:         Will move you to the character that left of the        Left-Arrow:                                                        
  2202.                             one you are located at currently inside of a
  2203.                             field.  If you are located all the way to the
  2204.                             left of a field, it will bring you to the pre-
  2205.                             vious field.
  2206.  
  2207.         Right-Arrow:        Will move you to the character that is        Right-Arrow:                                              
  2208.                             right of the one you are located at currently
  2209.                             inside of a field.  If you are located all the
  2210.                             way to the right of a field, it will bring you
  2211.                             to the next field.
  2212.  
  2213.         Ctrl-Left-Arrow:    Brings you to the field located to the        Ctrl-Left-Arrow:                                          
  2214.                             left of the one you are located at currently.
  2215.  
  2216.         Ctrl-Right-Arrow:   Will bring you to the field located to the        Ctrl-Right-Arrow:                                             
  2217.                             right of the one you are located at presently.
  2218.  
  2219.         Ins:                Toggles the insert mode on or off.  If the        Ins:                                                          
  2220.                             insert mode is enabled, whatever you type will
  2221.                             be displayed, and anything located to the right
  2222.                             will be moved over by a character.   If the
  2223.                             mode is disabled, anything you type will
  2224.                             destroy what is located at the cursor currently
  2225.                             and be replaced by the character which you
  2226.                             type.
  2227.  
  2228.         Del:                This will remove the character underneath of        Del:                                                            
  2229.                             your cursor from the screen.
  2230.  
  2231.         Backspace:          Will delete the character located to the        Backspace:                                                  
  2232.                             left of the cursor and move the cursor to the
  2233.                             left by one position.
  2234.  
  2235.         F1:                 This will erase the contents of a field.        F1:                                                         
  2236.  
  2237.         F2:                 This will restore the field to the way it was        F2:                                                              
  2238.                             originally before you began to edit it.
  2239.  
  2240.  
  2241.                                    -32-
  2242.  
  2243.  
  2244.  
  2245.  
  2246.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  2247.  
  2248.  
  2249.  
  2250.                                   Appendix E                                  Appendix E
  2251.  
  2252.            Sequence of Steps Performed by Omega-Link When It Begins           ________________________________________________________
  2253.  
  2254.          When Omega-Link begins, it performs several things that may be
  2255.     beneficial to know.  This is performed as follows:
  2256.  
  2257.          First, Omega searches for the defaults file (OMEGADEF.DAT) in the
  2258.     default directory of DOS.  If it cannot find the file, it will examine
  2259.     the path command inside of the DOS environment, and search down the
  2260.     path until it finds the file.  If it does not find the file, or it is
  2261.     not a valid defaults file for this version of Omega-Link, it will use
  2262.     its own internal defaults.  Note that if you store a new defaults file,
  2263.     it will be stored in the path where the old one was found (if any).
  2264.  
  2265.          After this, it will attempt to load the function key files and the
  2266.     dialing directory if it can find any.
  2267.  
  2268.          A main screen will be displayed.  After the main screen is exited
  2269.     and you are in the terminal mode, the macro defininition for ALT-F1
  2270.     will be executed if it is defined.
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.                                    -33-
  2308.  
  2309.  
  2310.  
  2311.  
  2312.                         Omega-Link Reference Manual                        Omega-Link Reference Manual
  2313.  
  2314.  
  2315.  
  2316.                                   Appendix F                                  Appendix F
  2317.  
  2318.                                 SUGGESTION FORM                                _______________
  2319.  
  2320.          If you have any comments or suggestions as to improvements for
  2321.     this program, please use this form.  If you would like a registration
  2322.     form for registering Omega, use the form available from the program
  2323.     when you exit.
  2324.  
  2325.          Also, if you find any serious bugs with the program, please con-
  2326.     tact us as soon as possible, either by telephone or mail.  For one, you
  2327.     may have stumbled upon a bad copy, and if this is the case, we would
  2328.     like to give you a good one.  We will send you a copy of the demon-
  2329.     stration program free for the asking if you send us a self addressed,
  2330.     stamped envelope that can carry a 5.25" or 3.5" disk (please specify
  2331.     which you would prefer).  Secondly, if it is a bug that really is in
  2332.     the program, we would like to know about it so that we may correct it
  2333.     as soon as possible.
  2334.  
  2335.          And if you do find any problems, please tell us where you obtained
  2336.     your copy of the program.
  2337.  
  2338.  
  2339.     Suggestions: __________________________________________________________
  2340.  
  2341.     _______________________________________________________________________
  2342.  
  2343.     _______________________________________________________________________
  2344.  
  2345.     _______________________________________________________________________
  2346.  
  2347.     _______________________________________________________________________
  2348.  
  2349.     _______________________________________________________________________
  2350.  
  2351.                    (Please use back for additional comments)
  2352.  
  2353.     Your Name: ____________________________________________________________
  2354.  
  2355.       Address: ____________________________________________________________
  2356.  
  2357.          City: __________________________  State: ______  Zip: ____________
  2358.  
  2359.     Telephone No.: (_________) _____________ - ____________________________
  2360.  
  2361.     Computer Type: ________________________________________________________
  2362.  
  2363.          All correspondence can be addressed to:
  2364.  
  2365.          (Mail)                              (Telephone)
  2366.          Omega Software                      (616) 962-8007
  2367.          P.O. Box 1471                       Hours: 11 A.M. - 10 P.M.
  2368.          Battle Creek, MI  49016-1471               Eastern Time
  2369.                                              Seven Days a Week
  2370.  
  2371.  
  2372.  
  2373.                                    -34-
  2374.  
  2375.  
  2376.  
  2377.